home *** CD-ROM | disk | FTP | other *** search
/ Atari Forever 4 / Atari Forever 4.zip / Atari Forever 4.iso / SERIE_S / S_837 / S_837.ZIP / HTML / README < prev   
Text File  |  1995-09-17  |  13KB  |  299 lines
  1. HTML-Browser V0.93β (May 1995)     Atari ST/TT/Falcon/Medusa/Eagle/MagiC Mac
  2. ============================================================================
  3.  
  4. At last Atarians can join the World Wide Web revolution! Using 
  5. HTML-Browser you'll be able to browse HTML files off-line. Currently 
  6. you'll have to download the HTML files separately, or read them 
  7. directly from CD-ROM, because HTML-Browser has no on-line capability 
  8. but if the browser generates enough support and feedback anything is 
  9. possible, it's up to you!
  10.  
  11. Distribution
  12. ------------
  13. HTML-Browser is FREEWARE. It may be copied and used freely. 
  14. Distribution by BBSs and PD libraries is allowed. However, HTML-Browser 
  15. may NOT under ANY circumstances be included in CD-ROM collections or on 
  16. magazine cover disks without my prior written permission. HTML-Browser 
  17. and its documentation must always remain together and complete with all 
  18. its files and documentation. Changes to the program and/or 
  19. documentation is forbidden.
  20.  
  21. If you like HTML-Browser and you use it regularly, please make a 
  22. donation, any currency is welcome, UK users refer to SUPPORT.TXT for 
  23. more details.
  24.  
  25. What's an HTML Browser?
  26. -----------------------
  27. Using this program you can view HTML documents from disk or CD however 
  28. this program can NOT be used to view World Wide Web (WWW) pages on-line 
  29. on the Internet.
  30.  
  31. A glance at the version number should tell you this program is still at 
  32. an early stage of development so if you would like to see this program 
  33. developed please send some feedback and register your copy locally in 
  34. the UK (refer to SUPPORT.TXT for details). No feedback means no 
  35. development, it's that simple!
  36.  
  37. My address:
  38. Alexander Clauss
  39. Stresemannstr. 44
  40. D-64297 Darmstadt
  41. Germany
  42.  
  43. UK support:
  44. Joe Connor
  45. 65 Mill Road
  46. Colchester
  47. CO4 5LJ
  48. England
  49.  
  50. Email contacts:
  51. Author: Alexander Clauss: aclauss@rbg.informatik.th-darmstadt.de
  52. UK support: Joe Connor: jconnor@cix.compulink.co.uk
  53. Original translation: Ben Bell: bjb@bigbox.demon.co.uk
  54.  
  55.  
  56. Installation
  57. ------------
  58. HTML-Browser can be used as either a desktop accessory or a normal GEM 
  59. application. To install as a desktop accessory rename HTML.APP to 
  60. HTML.ACC and place it and HTML.RSC in the root directory of your boot 
  61. drive.
  62.  
  63. First you need to tell the program which (GDOS) fonts to use for each 
  64. corresponding style in an HTML document. Vector fonts as provided by 
  65. SpeedoGDOS or NVDI 3.x are recommended. You must specify three fonts 
  66. (sans-serif, serif and monospaced) in four different styles (normal, 
  67. bold, italic and bold and italic) making twelve selections altogether.
  68. For the bold and italic settings you should use a 'real' bold or italic 
  69. font wherever possible. If you don't have one available you'll have to 
  70. simulate these text effects using the corresponding buttons adjacent to 
  71. the font selection popup. If you're using vector fonts then use the 
  72. appropriate font from the font family, if available.
  73.  
  74. The supplied INF file has the following presets (for NVDI 3.x):
  75.  
  76. Headings:    Swiss 721 (normal, bold, italic, bold+italic)
  77. Normal text: Dutch 801 (normal, bold, italic, bold+italic)
  78. Formatted:   Letter Gothic 12 Pitch (normal, bold, italic, bold+italic)
  79.  
  80. If you don't like or haven't got these fonts, you'll have to select 
  81. alternatives.
  82.  
  83. The size of the body text can also be altered. Don't make this too 
  84. large or too small! Somewhere between 10 and 14 point is sensible (I 
  85. use 12 point).
  86.  
  87. If you haven't got access to vector fonts (i.e. you don't own a copy of 
  88. NVDI 3.x or SpeedoGDOS) then the point size won't change, but the text 
  89. can still be viewed using the system font, usually 10 point.
  90.  
  91. If a link in an HTML document points to a file which is not in HTML 
  92. format, an external viewer can be called. These programs can be called 
  93. in one of two ways and are configurable via the 'External programs...' 
  94. dialog via the 'Options' menu.
  95.  
  96. The two methods are:
  97.  
  98. 1) Via the VA_START message. The program must be memory resident which 
  99.    means installed as a desktop accessory under single TOS or as an 
  100.    application under a multitasking OS which must support the VA_START 
  101.    call. If the program is not running and the user is running under a 
  102.    multitasking OS, HTML-Browser tries to execute the external program 
  103.    itself, but this isn't possible under single TOS if HTML-Browser is 
  104.    running as an accessory.
  105. 2) EXEC: The program will always be executed. You'll have to use this 
  106.    option if the program called doesn't support the VA start protocol. 
  107.    Once again this cannot be used if HTML is running as a desktop 
  108.    accessory under single TOS.
  109.  
  110. Different file extensions can be viewed with different viewers. 
  111. Remember to set the execution method to either VA_START or EXEC. The 
  112. default viewer is called if there is no viewer available for the 
  113. particular file extension.
  114.  
  115. When started, HTML-Browser looks for a file called home.html (HOME.HTM 
  116. on TOS file systems. If you can write documents in the HTML language 
  117. then you can write yourself a home page which is automatically loaded. 
  118. This page could contain a list of links to other pages you may want to 
  119. access frequently.
  120.  
  121. Navigating HTML Documents
  122. -------------------------
  123. Click on any underlined keyword to branch to the new page. Press the 
  124. [Undo] key to step to return to the previous page. To make it easy to 
  125. test the program I've included the file 'test.htm' which can be found 
  126. in the 'test.doc' directory.
  127.  
  128. Display
  129. -------
  130. In this dialog you can configure various display options for HTML 
  131. documents.
  132.  
  133. Colours:
  134. This section allows you to configure the display colours, for the 
  135. foreground text, the background colour and link colour. If you're using 
  136. less than 16 colours, the window background will always be white 
  137. regardless of the settings here. In 16 colour mode, only the first nine 
  138. colours should be used as the last 7 may be changed for pictures etc. 
  139. In more than 16 colours, any of the first 16 can be used as they will 
  140. not be changed.
  141.  
  142. Links:
  143. Links can be displayed in underlined and/or bold text (this is 
  144. important for monochrome systems who can't distinguish links by 
  145. colour).
  146.  
  147. Images:
  148. Controls image display.
  149.  
  150. 'Don't show'
  151. Prevents images being loaded and displayed which speeds up page 
  152. loading.
  153.    
  154. 'Monochrome'
  155. Images are displayed in monochrome using dithering. It's the quickest 
  156. method but this obviously the quality suffers.
  157.    
  158. 'Greyscale'
  159. Images are displayed as greyscales. Higher quality display at the 
  160. expense of speed.
  161.  
  162. 'Colour'         
  163. Not yet implemented.
  164.   
  165. 'Without alt. text'
  166. The HTML language provides for text-only systems by allowing images to 
  167. be accompanied by some text which is displayed instead of the image. 
  168. HTML-Browser can be made to display this text in addition to the image 
  169. by deselecting this option (checkbox uncrossed). Selecting this option 
  170. (checkbox crossed) supresses the alternative text if the image is 
  171. displayed.
  172. Tip for c't-CDROM users:
  173. If this button is switched on, images will not be displayed in normal 
  174. text.
  175.  
  176. Home Page
  177. ---------
  178. This menu item will display the standard home page, home.html.
  179.  
  180. Hotlist
  181. -------
  182. The hotlist is a list of your most used HTML documents. This list 
  183. enables you to get quickly to you favourite pages, without having to 
  184. navigate through a long series of pages to get there. To place a page 
  185. in the hotlist, select 'Document -> Hotlist'.
  186.  
  187. Selecting 'Hotlist' displays a dialog containing the page hotlist. The 
  188. button "Add" adds the current page to the hotlist. Double click on an 
  189. entry or select it then press 'Open' opens the selected page.
  190. 'Delete' removes the page from the hotlist, and 'Change' allows the 
  191. page title to be edited and view the filename of the page it points to.
  192.  
  193. Paths...
  194. --------
  195. See 'Find keyword...'
  196.  
  197. Find keyword...
  198. ---------------
  199. This allows the user to perform a search for keywords in HTML files, 
  200. and can optionally be case sensitive. The search can be conducted over 
  201. one of the following ranges of documents:
  202.  
  203. 1) Current document only. The text is searched for in the current 
  204.    document (the top window). If the text is found the window is 
  205.    scrolled so the text is displayed at the top of the window.
  206.    
  207. 2) Local HTML Documents. The text is searched for in all local HTML 
  208.    documents contained in the paths specified in the 'Paths' dialog box 
  209.    (and their subdirectories). The files that contain the text is made 
  210.    into a list of links in an HTML file called 'result.html'.
  211.    At the moment the HTML files searched by method two are searched 
  212.    purely as text, so hidden text such as comments, HTML commands, 
  213.    links and so are also found. Processing the files to ignore hidden 
  214.    text would be very time costly. This also means that special 
  215.    characters such as accents and so on which are written into HTML 
  216.    code using commands like 'ä' are not found. This shortcoming may 
  217.    be addressed in a future version.
  218.    Another tip: If you're searching for something which is often used 
  219.    in HTML code as a command or URL-address placing a space before it 
  220.    may make it less likely to turn up in commands or URL addresses..
  221.    For example: Searching for the text 'WWW' often matches 
  222.    subdirectories and addresses for pages in the form 
  223.    '.../WWW/foo.html...'. Placing a space before it in the search 
  224.    string, ' WWW' removes these occurences resulting in a better 
  225.    targetted search. These don't apply to methods 1) and 3)!
  226.    
  227. 3) In the c't-CDROM Database. This option is only useful for people 
  228.    with the c't-CDROM (the 1994 c't magazines in HTML format)!
  229.    In this case the HTML files themselves aren't searched, but the 
  230.    index file on the CD is accessed instead. So that HTML-Browser knows 
  231.    where the files for this CD are kept are, you need to fill in the 
  232.    appropriate section of the 'Paths' dialog box - the HTML documents 
  233.    (in \HTML which also contains the file DEFAULT.HTML) and the index 
  234.    database (\UNIX\CT94.DAT). As in the previous method, matching 
  235.    documents are made into an HTML document calle results.html which is 
  236.    then opened.
  237.  
  238. Using HTML-Browser
  239. ------------------
  240. All the functions of the program that are controlled by the menu bar 
  241. can also be accessed by a popup menu. This menu is brought up by 
  242. clicking the left mouse button on the viewer window (not on a link). 
  243. This is essential for desk accessories which can't install their own 
  244. menu bars. Clicking on a link using the right mouse button will display 
  245. the address of the page it links to.
  246.  
  247. Technical Details
  248. -----------------
  249. Currently HTML-Browser cannot be used on-line on the Internet using 
  250. TCP/IP.
  251. The program understands the majority of the HTML2 specification. The 
  252. form and entry functions are not yet implemented but since these are 
  253. only really needed on-line their omission shouldn't bother anybody. The 
  254. same applies to 'Image maps'.
  255. Transparent colour images will be displayed, where available, using 
  256. greyscales.
  257.  
  258. Limitations
  259. -----------
  260. - Embedded images can only be viewed in monochrome (or greyscales).
  261. - Can't access the internet on-line directly.
  262.  
  263.  
  264. Possible future updates
  265. -----------------------
  266. These depend on a good level of response from users. No support means 
  267. no development!
  268. -Improved documentation!
  269. -Support for the HTML3 specification (tables, forumlae, etc.)
  270. -Displaying embedded images in colour
  271. -Better font setup and handling of bitmap fonts
  272. -Online Internet access. If you're prepared to program this should talk 
  273.  to me!
  274.  
  275. Please feel free to make further suggestions and constructive 
  276. criticisms...
  277.  
  278. History
  279. -------
  280. V0.8ß  20.04.1995 -First release version
  281.  
  282. V0.9ß  15.05.1995 -Reduced memory requirements
  283.                   -MTOS Drag&Drop (ARGS) supported
  284.                   -External programs will now run under singleTOS
  285.                   -Error reports are now more descriptive
  286.                   -Bugfix: when running as an accessory no longer
  287.                    tries to invert (non-existant) menu items
  288.                   -The .INF file is now found even if HTML is not
  289.                    started in it own directory.
  290.                   -Is now a lot more tolerant of buggy HTML file
  291.                    syntax. -home.html is now loaded on startup if 
  292.                    possible
  293.                   -Hotlist
  294.                   -Configuration of window and text colours etc.
  295.                   -Search (including searching c't CDROM)
  296.                   -Display inline images as greyscales.
  297. ---------------------------------------------------------------------------
  298. EOF 
  299.